home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 098 / newlu.lqr / LUU16.DOC < prev    next >
Text File  |  1985-06-03  |  4KB  |  112 lines
  1.  
  2. LUU Command
  3. -----------
  4.  
  5. Purpose:   Add or replace members in an LU or LAR type library.
  6.  
  7. Format:    LUU     [d:][path]filename[.LBR]  filename(s)
  8.  
  9. Remarks:   The library name and at least one input member file name
  10.        must be supplied. The library name may contain a drive,
  11.        path names, and a filename with an extension. If the
  12.        library extension is omitted, .LBR is assumed.
  13.  
  14.        There may be one or more member file names. Separate
  15.        each member name by one blank. Each member name may include
  16.        a drive, path names, and wildcard characters in the file
  17.        name and extension.
  18.  
  19. Notes:       Written for the IBM PC using DOS 2.0 or later.
  20.        Copyright (c) 1984 by Vernon Buerg, for public domain use.
  21.  
  22.        LUU duplicates the A(dd) and U(pdate) functions of LU.
  23.        When used with LUT and LUE, original file dates are
  24.        preserved and recorded.
  25.  
  26.        The advantages of LUU are:
  27.  
  28.         - smaller, so a copy can be kept on the "system" disk
  29.         - faster, mucho
  30.         - handles paths and wildcards
  31.         - retains input file (or member) date/time
  32.         - replaces in place
  33.  
  34. Examples:
  35.        LUU a:AQM.LBR  b:*.AQM
  36.        LUU PCT366 b:PCT366.*
  37.        LUU c:\test\source.lbr  b:ab??xx.*  a:\prod\*.asc
  38.  
  39.  
  40. File Formats:
  41.  
  42.            An LBR file consists of a directory and one or more
  43.        "members". The directory contains from 4 to 256 entries.
  44.        Each entry is 32 bytes long and describes a member, if
  45.        one exists.
  46.  
  47.         The first directory entry describes the directory
  48.        itself. Thus, the number of entries allocated is increased
  49.        by one.
  50.  
  51.         All space allocation is in terms of sectors. Each
  52.        sector is 128 bytes long. Four directory entries fit
  53.        in one sector, so the directory is allocated in multiples
  54.        of four.
  55.  
  56.         There are three directory formats recognized by LUU.
  57.        They are: 1) old LU, 2) LUPC, and 3) new LU86. When a new
  58.        library is created, LUU uses the new LU86 directory format.
  59.        If LUU is updating an existing LBR file, it uses the same
  60.        format that the file was created with.
  61.  
  62.             Directory format
  63.             ----------------
  64.         0 - File status; 0=active, 254=deleted, 255=free
  65.         1 - Member name; filename in FCB format, dir name is blanks
  66.            12 - Offset to data in sectors of 128 bytes
  67.            14 - Length of member in sectors.
  68.            16 - all zero for 'old LU' format
  69.  
  70.             LUPC format extension
  71.             ---------------------
  72.         1 - master directory name is ********DIR
  73.            16 - Original member file creation date, MM/DD/YY
  74.            24 - Original member file creation time, HH:MM:SS
  75.  
  76.             LU86 Directory Format
  77.             ---------------------
  78.  
  79.         0 - File status; 0=active, 254=deleted, 255=free
  80.         1 - Member name; filename in FCB format, dir name is blanks
  81.            12 - Offset to data in sectors of 128 bytes
  82.            14 - Length of member in sectors.
  83.            16 - CRC word, or zero if Cyclic Redundancy Checking not used
  84.            18 - File create date, CP/M format
  85.            20 - File create time, DOS format
  86.            22 - Date file last updated (replaced), CP/M format
  87.            24 - Time file last updated, DOS format
  88.            26 - Number of bytes in last sector
  89.            27 - reserved/unused/zero
  90.  
  91.  
  92.        The date and time stamp fields vary in format. LUU uses
  93.        the LU86 format when it creates a library. Otherwise, the
  94.        format used when the library was created is used.
  95.  
  96.        The member name for the directory entry is all blanks.
  97.        This allows for compatibility checking between versions
  98.        of LU and LUU.
  99.  
  100.  
  101.        Version 1.2, July 30, 1984.
  102.        Version 1.3, August 6, 1984.
  103.          -    Ignore CRC bytes in directory.
  104.          -    Update in place if replacement member is same size
  105.         or smaller, of is last member in directory.
  106.        Version 1.4, August 13, 1984.
  107.          -    recognize new CPM date/time stamp format
  108.        Version 1.5, December 21, 1984,
  109.          -    allow multiple member names to be specified
  110.        Version 1.6, January 23, 1984,
  111.          -    default to LU86 directory format
  112.